home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / util / blank / AntiBlanker.lha / AntiBlanker.readme < prev   
Text File  |  2000-02-28  |  8KB  |  201 lines
  1. Short:    A tool that disables your screen blanker when certain tasks are running
  2. Uploader: Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  3. Author:   Ghandi <ghandi@cremlinsoftware.org> and Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  4. Type:     util/blank
  5. Replaces: AntiBlanker.lha
  6.  
  7.  
  8. Why was it written?
  9. ~~~~~~~~~~~~~~~~~~~
  10. Because the screen blanker we were using would eat up too much CPU time when we
  11. were trying to burn CDRs thus ruining them, and we kept forgetting to disable
  12. it beforehand, so we thought we would get our Amiga to do it for us.
  13.  
  14.  
  15. How do I run AntiBlanker from Workbench?
  16. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  17. Just double click on the AntiBlanker icon.  In order to tell AntiBlanker what
  18. tasks to look out for you must setup it's ToolTypes as follows:
  19.  
  20. DELAY=<the delay between checks (in 1/50ths of a second)>
  21. BLANKCODE=<the blank key code, see below>
  22. BLANKQUALIFIER=<the blank qualifier, see below>
  23. TASK=<the task name you would like to disable your screen blanker for>
  24.  
  25. e.g.:
  26.  
  27. DELAY=6000
  28. BLANKCODE=0x0062
  29. BLANKQUALIFIER=0x0004
  30. TASK=MakeCD
  31. TASK=PalomaTV
  32.  
  33. The above would disable your screen blanker when ever MakeCD or PalomaTV are
  34. running, and it will check to see if they are running every 2 minutes
  35. (6000/50/60 = 2 minutes), but
  36.  
  37.  
  38. How do I run AntiBlanker from the CLI?
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40. Type the following at a CLI prompt:
  41.  
  42. <Path>AntiBlanker <Config #1> <Config #2> ... <Config #n>
  43.  
  44. Where <Config #n> are any number of configuration files, AntiBlanker will
  45. automatically append them all together.  The format of the configuartion files
  46. are as follows:
  47.  
  48. Line1      The delay between check (in 1/50ths of a second).
  49.            Same as DELAY tooltype.
  50. Line2      The blank key code (see below).
  51.            Same as BLANKCODE tooltype.
  52. Line3      The blank qualifier (see below).
  53.            Same as BLANKQUALIFIER tooltype.
  54. Line4 .. x The task name you would like to disable your screen blanker for.
  55.            Same as TASK tooltype.
  56.  
  57. nb.  When using multiple configuration files, AntiBlanker uses the DELAY,
  58. BLANKCODE and BLANKQUALIFIER from the last configuration file specified.
  59.  
  60.  
  61. What are the blank code and blank qualifier?
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  63. AntiBlanker works by putting 'fake' input events onto the input chain, thus
  64. fooling your screen blanker into thinking you've pressed a key when you
  65. haven't.  Versions before 0.4 used the Control (Ctrl) key for this purpose as
  66. we thought it was least likely to cause any conflicts, unfortunately we did not
  67. fill in the input event with a single Control, but instead we accidentally set
  68. it to <Ctrl> + <'> and this would produce 'trash' in a shell window and in some
  69. software.
  70.  
  71. As of version 0.5 you can specify the blank code and blank qualifier (see
  72. above), this allows you to program AntiBlanker to 'fool' the system with any
  73. key you like.  You can specify the codes as hex or decimal by copying them
  74. exactly from the tables below (the tables are not complete, but should get you
  75. started).
  76.  
  77. Blank codes
  78. ~~~~~~~~~~~
  79. Key               Hex Code      Decimal Code
  80. ---               --------      ------------
  81. Left Shift        0x0060        96
  82. Right Shift       0x0061        97
  83. Caps Lock         0x0062        98
  84. Control           0x0063        99
  85. Left Alt          0x0064        100
  86. Right Alt         0x0065        101
  87. Left Amiga        0x0066        102
  88. Right Amiga       0x0067        103
  89.  
  90. nb.  The above blank codes work on our A1200, although they may be slightly
  91. different for other Amigas (and possibly foreign keyboards), if you get 'trash'
  92. in a shell window while using AntiBlanker try a different code.
  93.  
  94. Blank qualifiers
  95. ~~~~~~~~~~~~~~~~
  96. Key               Hex Code      Decimal Code
  97. ---               --------      ------------
  98. Left Shift        0x0001        1
  99. Right Shift       0x0002        2
  100. Caps Lock         0x0004        4
  101. Control           0x0008        8
  102. Left Alt          0x0010        16
  103. Right Alt         0x0020        32
  104. Left Amiga        0x0040        64
  105. Right Amiga       0x0080        128
  106.  
  107. If you find one of the above keys conflicts with your software try another.
  108. nb.  the Caps Lock codes do not appear to actually affect the status of
  109. Caps Lock.
  110.  
  111.  
  112. Which blankers work with AntiBlanker?
  113. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  114. AntiBlanker has been tested and proven to work with the following screen
  115. blankers, although it should work with almost any screen blanker.  If you have
  116. tested it with a blanker not listed, please let me know the results so that we
  117. can update the list.
  118.  
  119. Blanker                           AntiBlanker version
  120. -------                           -------------------
  121. extras:tools/commodities/Blanker  0.1+
  122. util/cdity/mcx280.lha             0.1+
  123. util/blank/ASwarmII2_0.lha        0.2+
  124. util/blank/Auror15a.lha           0.2+
  125. util/blank/BeyondTheDark.lha      0.2+
  126. util/blank/Blanker2.6.lha         0.2+
  127. util/blank/DesktopMAGIC.lha       0.2+
  128. util/blank/GBlanker36.lha         0.2, 0.3, 0.5+
  129. util/blank/GBlanker36_020.lha     0.2, 0.3, 0.5+
  130. util/blank/FlyingToasters.lha     0.2+
  131. util/blank/ShadowMaster.lha       0.2+
  132. util/blank/StarBlanker.lha        0.2+
  133. util/blank/SwazBlanker240.lha     0.2+
  134.  
  135.  
  136. Miscellaneous notes
  137. ~~~~~~~~~~~~~~~~~~~
  138. Task names are CASE SENSITIVE, you can find out the name of task via a tool
  139. such as Scout.
  140.  
  141. To stop AntiBlanker, send it a CTRL-C signal either via the Break/BreakName
  142. programs or by a tool such as Scout.  Please note that AntiBlanker will not end
  143. immediately but after it's next loop.
  144.  
  145. To get the most performance out of AntiBlanker (so that it uses the least CPU
  146. time), put the tasks that you use most at the bottom of the configuration file
  147. (or tool type list).  Due to the way AntiBlanker stores the task names
  148. internally it actually checks for the tasks in the reverse order to the how you
  149. specified them.
  150.  
  151.  
  152. Registration and contacting us
  153. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  154. AntiBlanker is 'Email Ware', this means that if you use it then you must send
  155. us an email.  As you can see this is a very small cost to pay.
  156.  
  157. Also feel free to visit our website at http://www.cremlinsoftware.org it hosts
  158. all the latest versions of our software (including BETA releases).
  159.  
  160.  
  161. AntiBlanker history
  162. ~~~~~~~~~~~~~~~~~~~
  163.  
  164. Version   Date         Notes
  165.  
  166. 0.1       15.06.1998   ·First public release.
  167.  
  168. 0.2       15.06.1998   ·Fixed AntiBlanker so that it works with Garshneblanker.
  169.                         [Luca 'Hexaae' Longone]
  170.  
  171. 0.3       05.09.1998   ·Fixed an Enforcer hit that was caused by our linked
  172.                         list class.
  173.                         [Luca 'Hexaae' Longone]
  174.  
  175. 0.4       14.09.1998   ·Added user definable blank key.
  176.                        ·Altered the code so it sends a KEY_UP event instead of
  177.                         a KEY_DOWN.  This should reduce the amount of conflicts
  178.                         with existing software.
  179.  
  180. 0.5 BETA  15.09.1998   ·Added The BlankCodeFinder program to the AntiBlanker
  181.                         package.
  182.                        ·Changed user definable blank key so that it is
  183.                         specified as a CODE and QUALIFIER, instead of just a
  184.                         QUALIFIER.
  185.                        ·Altered the code so it sends a KEY_DOWN event like 0.3
  186.                         did, as we had forgotten this was necessary for
  187.                         Garshneblanker compatibility (oops).
  188.  
  189. 1.0       15.02.2000   ·Finally fixed the Enforcer hit on startup (that only
  190.                         took 1½ years).
  191.                         [Luca 'Hexaae' Longone]
  192.                        ·Configuration file(s) are now closed properly.
  193.                        ·Added CTRL-C support.
  194.                        ·A number of internal optimisations and recompiled with
  195.                         the new OS3.5 includes.
  196.  
  197. 1.1       28.02.2000   ·Our linked list class has been enhanced and cleaned up
  198.                         for one of our other projects, so we have recompiled
  199.                         AntiBlanker to accomodate the new class.
  200.                         No real changes have been made to the program itself.
  201.